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Chapter 1 


Package Manager API 


1.1 References 


[1] Software Architecture Document, Version 1.1 Revision 1.4, LiMo Foundation, 11 September 2007 


1.2 Overview 


1.2.1 PM Plug-in 


The package manager (PM) is a standalone, command line LiMo application/process. It is for: 


1. install/update application 


2. uninstall application 


3. move application between internal memory and external storage 
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Figure 1.1: Package Manager Architecture 


PM interacts with plug-ins to accomplish tasks. Figure 1 shows a high level architecture of PM. 


1. Each PM plug-in instance is a separate linux shared object. 


2. This object implements one or more functions such as PM. PreInstall, PM. PostInstall, etc. 


3. This object file path is listed in plugin.conf. 


4. PM loads all plug-ins listed in plugin.conf upon startup, and unloads them on exit. 


5. When PM is going to use a plug-in function, for instance, PM PreInstall, PM tries to invoke PM - 
PreInstall in all plug-ins if found. 


6. PM invokes the plug-ins one by one. If one plug-in reports an error(i.e. returns a non-zero value), 
the installation will fail. 


7. If an error occurs, PM, Runtimelnfo::rollback is set to non-zero, and all successful plug-in functions 
will be called again. A Plug-in should always check this if value when called. 


1.2.20 PM Workflow 


Figure 2 shows how to invoke plug-ins. 
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1.2 Overview 


Check system status 
Install / Update Uninstall and recover if necessary 


Figure 1.2: PM Plug-in Invocation Workflow 


Figure 3 shows the workflow of PM. 
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Figure 1.3: PM Workflow 


1.2.3 Plug-in Invocation Order and Plugin.conf 


When PM starts, it loads all plug-ins and calls PM_PluginInit on all plug-ins if present. Before PM exits, 
it call PM_PluginExit on all plug-ins. Each plug-in can publish a startup event and an end event through 
these two interfaces, and in PM, Pluginlnit, it can create a thread to check PM_RuntimeInfo::progress and 
publish progress event accordingly. 


Plugin.conf lists the locations of plug-ins for each function. PM invokes the plug-ins in the same order as 
they listed in this file. If one of the plug-in fails, compensatory function is called on the plug-ins that has 
been invoked for rollback. The compensatory order is first invoked, last compensated. 


See plugin.conf, virusscan.c, mainmenu.c, scripting.c for code samples. 


1.3 Industry Standard 


None 


1.4 External API Documents 


None 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


1.5 Plug-in Extension Point Interface 


1.5 Plug-in Extension Point Interface 


None 


1.6 Other Interfaces 


None 


1.7 Other Notes 


None 
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Chapter 2 


Class Index 


2.1 Class List 


Here are the classes, structs, unions and interfaces with brief descriptions: 


PM. Descriptor (The information of the descriptor) ....... o... o... . e... . +... 1 
PM MPKGManager (This class is the entry point for installing, updating, moing, uninstalling a 
MPKG package): oeste aros 9 X Ow e Fe ROGO s 33 ORO SEDE BUE 17 


PM_Runtimelnfo (The information used during the runtime. The NOT available values is pre- 
sented as NULL: j-p a oso pang dede Yo Punde eB E HR OR AE Es e ee 20 


Class Index 
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Chapter 3 


File Index 


3.1 File List 


Here is a list of all documented files with brief descriptions: 


ComponentOverview.h (Component Programming Interface Overview Header Template for 
Dn A he EM eA eS Shee Eo hake OER a 
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File Index 
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Chapter 4 


Class Documentation 


4.1 PM Descriptor Struct Reference 
finclude «PM Plugin.h» 
4.1.1 Detailed Description 


The information of the descriptor. 


Examples: 


mainmenu.c, scripting.c, and virusscan.c. 


Public Attributes 


const char * descriptor Version 
const char x appIcon 

const char * logicalAppLoc 
const char * appUniqueID 
const char x appName 
const char x appExecName 
const char * appExecArgs 
const char * pkgType 

const char x appModel 
const char * appClass 

const char * mainMenuLoc 


const char x description 
const char ** startupEvents 
const char xx mimeTypes 
const char ** extentions 


const char * version 


const char x vendor 


const char « releaseDate 
int isLockable 
int isErasable 
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int isAutoRun 


int requiredSpace 


const char x descriptor Version 


const char x appIcon 


const char * logicalAppLoc 


const char * appUniqueID 


const char x appName 


const char x appExecName 


const char * appExecArgs 


const char * pkgType 


const char x appModel 


const char * appClass 


const char x mainMenuLoc 


const char x description 


const char ** startupEvents 


const char xx mimeTypes 


const char xx extentions 


const char * version 


const char x vendor 


const char x releaseDate 


4.1.2 Member Data Documentation 
4.1.2.1 const charx PM_Descriptor::descriptor Version 


Descriptor file's version 


4.1.2.2 const charx PM. Descriptor::appIcon 


Name of the icon used to display the application 


4.1.2.3 const charx PM_Descriptor::logicalAppLoc 


Location of the application on the phone/device menu 


4.1.2.4 const charx PM. Descriptor::appUniqueID 


Unique application ID of the application in the package 


4.1.2.5 const charx PM. Descriptor::appName 


Human readable name of the application 


4.1.2.6 const charx PM. Descriptor::appExecName 


Name of the binary application executable 
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4.1.2.7 const charx PM_Descriptor::appExecArgs 


Command-line arguments required by the application 


4.1.2.8 const charx PM_Descriptor::pkgType 


Type of package. The package type indicates new installation or update 


4.1.2.9 const charx PM_Descriptor::appModel 


One of following names: app-model-sharedlib, app-model-executable, -app-model-java, app-model- 
docview. 


4.1.2.10 const charx PM Descriptor::appClass 


Need to differentiate application types supported on the device, LiMo or any container-based, vendor- 
specific class 


4.1.2.11 const charx PM Descriptor::mainMenuLoc 


An opaque string with vendor-specific semantics, indicating where to place the application link within the 
Main Menu tree 


4.1.2.12 const charx PM Descriptor::description 


Text describing the functionality of the application 


4.1.2.13 const char«« PM. Descriptor::startupEvents 


Array of event/filters pairs, NULL terminated. Application will be lunched if one of events occurs. 


4.1.2.14 const char«« PM, Descriptor::mimeTypes 


Array of MIME types, NULL terminated. The MIME types the application can support/handle. 


4.1.2.15 const char«« PM_Descriptor::extentions 


Array of extentions, NULL terminated. The file extentsions application can support/handle. 


4.1.2.16 const charx PM. Descriptor::version 


Version of the application being installed or updated 


4.1.2.17 const char« PM Descriptor::vendor 


Vendor/Author of the application 
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4.1.2.18 const char« PM_Descriptor::releaseDate 


Release date of the application 


4.1.2.19 int PM_Descriptor::isLockable 


Specifies if the application can be locked for privacy 


4.1.2.20 int PM_Descriptor::isErasable 


Specifies if the application can be deleted 


4.1.2.21 int PM_Descriptor::isAutoRun 


Specifies if the application can be autorun 


4.1.2.22 int PM_Descriptor::requiredSpace 


Amount of memory (in bytes) required for the application on the device 


4.1.2.23 const char« PM_Descriptor::descriptor Version 


Descriptor file’s version 


4.1.2.24 const charx PM_Descriptor::appIcon 


Name of the icon used to display the application 


4.1.2.25 const char« PM_Descriptor::logicalAppLoc 


Location of the application on the phone/device menu 


4.1.2.26 const char« PM_Descriptor::appUniqueID 


Unique application ID of the application in the package 


4.1.2.27 const char« PM_Descriptor::appName 


Human readable name of the application 


4.1.2.28 const char« PM_Descriptor::appExecName 


Name of the binary application executable 
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4.1.2.29 const char« PM_Descriptor::appExecArgs 


Command-line arguments required by the application 


4.1.2.30 const char« PM_Descriptor::pkgType 


Type of package. The package type indicates new installation or update 


4.1.2.31 const char« PM Descriptor::appModel 


One of following names: app-model-sharedlib, app-model-executable, -app-model-java, app-model- 
docview. 


4.1.2.32 const char« PM Descriptor::appClass 


Need to differentiate application types supported on the device, LiMo or any container-based, vendor- 
specific class 


4.1.2.33 const char« PM Descriptor::mainMenuLoc 


An opaque string with vendor-specific semantics, indicating where to place the application link within the 
Main Menu tree 


4.1.2.34 const charx PM Descriptor::description 


Text describing the functionality of the application 


4.1.2.35 const char«« PM. Descriptor::startupEvents 


Array of event/filters pairs, NULL terminated. Application will be lunched if one of events occurs. 


4.1.2.36 const char«« PM, Descriptor::mimeTypes 


Array of MIME types, NULL terminated. The MIME types the application can support/handle. 


4.1.2.37 const char«« PM_Descriptor::extentions 


Array of extentions, NULL terminated. The file extentsions application can support/handle. 


4.1.2.38 const char« PM. Descriptor::version 


Version of the application being installed or updated 


4.1.2.39 const char« PM Descriptor::vendor 


Vendor/Author of the application 
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4.1.2.40 const char« PM_Descriptor::releaseDate 


Release date of the application 


The documentation for this struct was generated from the following files: 


* plugin/api/PM_Plugin.h 
* src/PM_Plugin.h 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


4.2 PM_MPKGManager Class Reference 17 


4.2 PM_MPKGManager Class Reference 


#include <PM_MPKGManager.h> 


4.2.1 Detailed Description 
This class is the entry point for installing, updating, moing, uninstalling a MPKG package. 
The class provides support for installing, uninstalling, updating and moving a MPKG package on a 


phones. The class uses PM_DescriptorParser to parse the descriptor files in the package This class is 
not multi-thread safe. 


Public Types 
* enum REGISTRY UPDATE TYPE T ( 
INVALID = 0, INSTALL APPLICATION, UPDATE APPLICATION, | MOVE - 
APPLICATION, 


UNINSTALL APPLICATION } 


Public Member Functions 


* PM MPKGManager () 


Default Constructor. 


PM MPKGManager (const string &domain) 
~PM_MPKGManager () 


Default Destructor. 


PM. RESULT CODE T handlePackage (const string &pkgFile, PM. DEVICE storage) 


Entry point for handling the MPKG document type. This method uncompresses the MPKG package in a 
temporary area for package validation and descriptor file parsing. 


PM. RESULT CODE T uninstallPkg (int appID) 


This method removes the installed package. Updates the relevant PM registries and removes the package 
specific files from the installed directory area. 


PM. RESULT CODE T movePkg (int appID, PM, DEVICE device) 


This method moves an already installed application package between the phone and the Memory Card. 
Updates the relevant PM registries. 


PM RESULT CODE T rollback () 


This method cleans up the system if any error occurs. 


void setSecurityDomain (const string &securityDomain) 


This method set the security domain for install/update package. Must be invoked before call PM - 
MPKGManager: :handlePackage. 


e PM RESULT CODE T initPlugin (int argc, char x**argv) 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


18 Class Documentation 


This method initializes the plugins listed in plugin.conf, and call PM Pluginlnit on each plugin. 


* void exitPlugin (int rc) 


This method calls PM PluginExit on each plugin, then unload them. error is ignored. 


4.2.20 Constructor & Destructor Documentation 
4.2.2.1 PM MPKGManager::PM MPKGManager () 


Default Constructor. 


4.2.2.2 PM_MPKGManager::~PM_MPKGManager () 


Default Destructor. 


4.2.3 Member Function Documentation 


4.2.3.1 PM RESULT CODE T PM MPKGManager::handlePackage (const string & pkgFile, 
PM. DEVICE storage) 


Entry point for handling the MPKG document type. This method uncompresses the MPKG package in a 
temporary area for package validation and descriptor file parsing. 


Parameters: 
pkgFile The path of the MPKG file on the phone. 


storage The storage type, internal or external. 


Returns: 


PM. RESULT SUCCESS if successful, 
related error value if error occurs. 


4.2.3.0. PM RESULT CODE T PM_MPKGManager::uninstallPkg (int appID) 


This method removes the installed package. Updates the relevant PM registries and removes the package 
specific files from the installed directory area. 


Parameters: 


appID The application ID. 


Returns: 


PM. RESULT SUCCESS if successful, 
related error value if error occurs. 
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4.2.3.3 PM RESULT CODE T PM_MPKGManager::movePkg (int appID, PM DEVICE device) 


This method moves an already installed application package between the phone and the Memory Card. 
Updates the relevant PM registries. 


Parameters: 


appID The application ID. 
device The target device where the app is being moved. 


Returns: 


PM. RESULT SUCCESS if successful, 
related error value if error occurs. 


4.2.3.4 PM RESULT CODE T PM MPKGManager::rollback () 


This method cleans up the system if any error occurs. 


4.2.3.5 void PM MPKGManager::setSecurityDomain (const string & securityDomain) 


This method set the security domain for install/update package. Must be invoked before call PM - 
MPKGManager::handlePackage. 


Parameters: 


securityDomain got from the cmdline parameters. 


4.2.3.6 PM RESULT CODE T PM MPKGManager::initPlugin (int argc, char ** argv) 


This method initializes the plugins listed in plugin.conf, and call PM PluginInit on each plugin. 


Parameters: 


argc number of cmdline parameters. 
argv array of cmdline parameters. 


Returns: 


PM. RESULT SUCCESS if successful, 
related error value if error occurs. 


4.2.3.7 void PM MPKGManager::exitPlugin (int rc) 


This method calls PM PluginExit on each plugin, then unload them. error is ignored. 
Parameters: 

rc return code that pm will return. 
The documentation for this class was generated from the following files: 


e PM MPKGManager.h 
e PM MPKGMangger.cpp 
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4.3 PM_Runtimelnfo Struct Reference 


#include <PM_Plugin.h> 


4.3.1 Detailed Description 
The information used during the runtime. The NOT available values is presented as NULL. 


Examples: 


mainmenu.c, scripting.c, and virusscan.c. 


Public Attributes 


int destStorageType 


const char * tempDirPath 


const char * packagePath 


const char * securityDomain 


int appID 


const char x installAppDir 


const char * oldAppDir 

char errorMessage [PM, MAX ERROR SIZE] 
int rollback 

int progress 


const char + tempDirPath 


const char * packagePath 


const char * securityDomain 


const char x installAppDir 


const char * oldAppDir 


4.3.2 Member Data Documentation 
4.3.2.1 int PM RuntimelInfo::destStorageType 


Internal or external storage. 


4.3.2.2 const charx PM Runtimelnfo::tempDirPath 
Path of temp directory which the pkg file is uncompressed to 


Examples: 


virusscan.c. 


4.3.2.3 const charx PM Runtimelnfo::packagePath 


Package file's path 
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4.3.2.4 const charx PM Runtimelnfo::securityDomain 


Security domain 


4.3.2.5 int PM Runtimelnfo::appID 


Application program ID 


4.3.2.6 const charx PM_RuntimeInfo::installAppDir 


The path which the extacted files will be deployed 


4.3.2.7 const char« PM Runtimelnfo::oldAppDir 


The path which contains the application files 


4.3.2.8 char PM Runtimelnfo::errorMessage 


[out] Plug-in will write error message into this field if an error occurs 


Examples: 


virusscan.c. 


4.3.2.9 int PM Runtimelnfo::rollback 


Non-zero indicates that some errors occur, PM will try to rollback. Plug-in should always check this 
value 


Examples: 


mainmenu.c, scripting.c, and virusscan.c. 


4.3.2.10 int PM RuntimelInfo::progress 


The progress of install/uninstall/move, this field is updated by PM online 


4.3.2.11 const charx PM Runtimelnfo::tempDirPath 


Path of temp directory which the pkg file is uncompressed to 


4.3.2.12 const char« PM Runtimelnfo::packagePath 


Package file's path 


4.3.2.13 const charx PM RuntimelInfo::securityDomain 


Security domain 
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4.3.2.14 const charx PM_Runtimelnfo::installAppDir 


The path which the extacted files will be deployed 


4.3.2.15 const charx PM Runtimelnfo::oldAppDir 


The path which contains the application files 


The documentation for this struct was generated from the following files: 


* plugin/api/PM Plugin.h 
* src/PM_Plugin.h 
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File Documentation 


5.1 ComponentOverview.h File Reference 


5.1.1 Detailed Description 


Component Programming Interface Overview Header Template for Doxygen. 


This file contains configuration information for documentation generation; it does not contain any API- 
specific information. 


24 
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Example Documentation 


6.1 mainmenu.c 


This is an example of the main menu code. 
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HIGHLY CONFIDENTIAL MATERIALS OF LIMO FOUNDATION AND ITS LICENSORS 
Copyright (c) 2006-2007 Motorola, Inc. 


Licensed under Foundation Public License (FPL), Version 1.0 or 
later (FPL (Non-Common Capable)). 

FPL V1.0 is attached as Annex B to the Intellectual Property Rights 
Policy, which is Annex A to the Bylaws of LiMo Foundation 

dated April 2, 2007. 


This source code software file contains highly confidential and 
proprietary information and is provided only to authorized members 
of the LiMo Foundation and other authorized entities for their use 
as provided by the LiMo Foundation bylaws, annexes, related 
documents and other governing documents. Possession or use by any 
other entity is strictly prohibited. Copies of the governing 
documents may be downloaded at www.limofoundation.org, or obtained 
directly from the LiMo Foundation by sending an e-mail to 
admin@limofoundation.org or by contacting: 


LiMo Foundation 

IEEE-ISTO 

445 Hoes Lane 

Piscataway, NJ 08854-4141 


This software file and its contents are provided on an "as is" 
basis without any express or implied warranty, including without 
limitation, any warranty that it is accurate, defect-free, free 
from infringement, contains particular functions or is suitable 
for a particular purpose. All express and implied statutory 
warranties are disclaimed, including without limitation, the 
warranty of merchantability, fitness for a particular purpose, 
title or non-infringement. 


NON-COMMON CAPABLE HEADER FILE 10-09-2007 


#include "PM Plugin.h" 


41 int PM PluginInit(int argc, charx» argv, PM RuntimeInfo »runtimeInfo) 


Example Documentation 


47 int 


53 int 


66 int 


79 int 


//intialize the plug-in 
return PM RESULT, SUCCESS; 
PM_PluginExit (int status, PM RuntimeInfo xrt) 


//clean up 
return PM RESULT, SUCCESS; 


PM PostInstall(PM RuntimeInfo xruntimeInfo, PM Descriptor» descriptor) 


if (runtimeInfo->rollback) 
{ 
//error occurred, do clean up 
} 
else 
( 
//update menu here 


} 
return PM_RESULT_SUCCESS; 


PM_PostMove (PM_RuntimeInfo *runtimeInfo, PM_Descriptorx* descriptor) 


if (runtimeInfo->rollback) 
{ 
//error occurred, do clean up 
} 
else 
{ 
//update menu here 
} 
return PM_RESULT_SUCCESS; 


PM PostUninstall(PM RuntimeInfo xruntimeInfo, 


if (runtimeInfo-»rollback) 
{ 
//error occurred, do clean up 
} 
else 
( 
//update menu here 


} 
return PM_RESULT_SUCCESS; 


PM Descriptor* descriptor) 
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6.2 plugin.conf 


This is an example configuration file. 


HIGHLY CONFIDENTIAL MATERIALS OF LIMO FOUNDATION AND ITS LICENSORS 
Copyright (c) 2006-2007 Motorola, Inc. 


Licensed under Foundation Public License (FPL), Version 1.0 or 
later (FPL (Non-Common Capable)). 

FPL V1.0 is attached as Annex B to the Intellectual Property Rights 
Policy, which is Annex A to the Bylaws of LiMo Foundation 

dated April 2, 2007. 


00 3004 € hN DP 


This source code software file contains highly confidential and 
proprietary information and is provided only to authorized members 
of the LiMo Foundation and other authorized entities for their use 
as provided by the LiMo Foundation bylaws, annexes, related 
documents and other governing documents. Possession or use by any 
other entity is strictly prohibited. Copies of the governing 
documents may be downloaded at www.limofoundation.org, or obtained 
directly from the LiMo Foundation by sending an e-mail to 

9 admin@limofoundation.org or by contacting: 


0 1001,» C) l0 LP Oo 


21 LiMo Foundation 

22 IEEE-ISTO 

23 445 Hoes Lane 

24 Piscataway, NJ 08854-4141 


25 

26 This software file and its contents are provided on an "as is" 
27 basis without any express or implied warranty, including without 
28 limitation, any warranty that it is accurate, defect-free, free 
29 from infringement, contains particular functions or is suitable 
30 for a particular purpose. All express and implied statutory 

31 warranties are disclaimed, including without limitation, the 

32 warranty of merchantability, fitness for a particular purpose, 
33 title or non-infringement. 

34 

35 NON-COMMON CAPABLE HEADER FILE 10-09-2007 

36 

37 

38 Package Manager Plug-in config 

39 

40 This file describes which plug-ins should be invoked 

41 during installation, move and uninstallation. 

42 

43 All the plug-ins will be listed in this file. One line one plug-in. 
44 

45 See PM workflow for more information. 

46 

47 ./plugin/virusscan.so 

48 ./plugin/scripting.so 

49 ./plugin/mainmenu.so 

50 
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6.3 scripting.c 


This is an example of the scripting code. 


1 o£ 
2 * HIGHLY CONFIDENTIAL MATERIALS OF LIMO FOUNDATION AND ITS LICENSORS 
3 * 
4 x Copyright (c) 2006-2007 Motorola, Inc. 
5 * 
6 x Licensed under Foundation Public License (FPL), Version 1.0 or 
7 x later (FPL (Non-Common Capable)). 
8 x FPL V1.0 is attached as Annex B to the Intellectual Property Rights 
9 x Policy, which is Annex A to the Bylaws of LiMo Foundation 
0 x dated April 2, 2007. 
1 * 
2 x This source code software file contains highly confidential and 
3 x proprietary information and is provided only to authorized members 
4 x of the LiMo Foundation and other authorized entities for their use 
5 x as provided by the LiMo Foundation bylaws, annexes, related 
6 xk documents and other governing documents. Possession or use by any 
7 x other entity is strictly prohibited. Copies of the governing 
8 x» documents may be downloaded at www.limofoundation.org, or obtained 
9 x directly from the LiMo Foundation by sending an e-mail to 
20 * admin@limofoundation.org or by contacting: 
21 x 
22 x LiMo Foundation 
23 æ IEEE-ISTO 
24 x 445 Hoes Lane 
25 x Piscataway, NJ 08854-4141 
26. 0d 
27 x This software file and its contents are provided on an "as is" 
28 x basis without any express or implied warranty, including without 
29 x limitation, any warranty that it is accurate, defect-free, free 
30 x from infringement, contains particular functions or is suitable 
31 x for a particular purpose. All express and implied statutory 
32 x warranties are disclaimed, including without limitation, the 
33 x warranty of merchantability, fitness for a particular purpose, 
34 x title or non-infringement. 
35 $ 
36 * NON-COMMON CAPABLE HEADER FILE 10-09-2007 
37 x/ 
38 
39 #include "PM Plugin.h" 
40 
41 int PM PluginInit(int argc, char xargv[], PM RuntimeInfo xruntimeInfo) 
42 ( 
43 //intialize the plug-in 
44 return PM RESULT SUCCESS; 
45 } 
46 
47 int PM PluginExit(int status, PM RuntimeInfo x*runtimelnfo) 
48 ( 
49 //clean up 
50 return PM RESULT SUCCESS; 
51 } 
52 
53 int PM PostInstall(PM RuntimeInfo *runtimelnfo, PM_Descriptorx* descriptor) 
54 ( 
55 if (runtimeInfo->rollback) 
56 ( 
57 //error occurred, do clean up 
58 } 
58 else 
60 { 
61 //run script here 
62 } 
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63 return PM_RESULT_SUCCESS; 

64 } 

65 

66 int PM PostMove(PM RuntimeInfo *runtimeInfo, PM_Descriptorx* descriptor) 
67 { 


68 if (runtimeInfo->rollback) 
69 { 

70 //error occurred, do clean up 
71 } 

72 else 

73 { 

74 //run script here 

75 } 

76 return PM_RESULT_SUCCESS; 
TAA 

78 


79 int PM PostUninstall(PM RuntimeInfo xruntimeInfo, PM Descriptor» descriptor) 
80 ( 


81 if (runtimeInfo->rollback) 
82 { 

83 //error occurred, do clean up 
84 } 

85 else 

86 ( 

87 //run script here 

88 } 

89 return PM_RESULT_SUCCESS; 
90 } 

91 
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6.4 virusscan.c 


This is an example of the virus scan code. 


1 /x 
2 * HIGHLY CONFIDENTIAL MATERIALS OF LIMO FOUNDATION AND ITS LICENSORS 
3 * 
4 x Copyright (c) 2006-2007 Motorola, Inc. 
5 * 
6 x Licensed under Foundation Public License (FPL), Version 1.0 or 
7 x later (FPL (Non-Common Capable)). 
8 x FPL V1.0 is attached as Annex B to the Intellectual Property Rights 
9 x Policy, which is Annex A to the Bylaws of LiMo Foundation 
0 x dated April 2, 2007. 
To k 
2 x This source code software file contains highly confidential and 
3 x proprietary information and is provided only to authorized members 
4 x of the LiMo Foundation and other authorized entities for their use 
5 x as provided by the LiMo Foundation bylaws, annexes, related 
6 x» documents and other governing documents. Possession or use by any 
7 x other entity is strictly prohibited. Copies of the governing 
8 x» documents may be downloaded at www.limofoundation.org, or obtained 
9 x directly from the LiMo Foundation by sending an e-mail to 
20 * admin@limofoundation.org or by contacting: 
21 > 
22 x LiMo Foundation 
23 æ IEEE-ISTO 
24 x 445 Hoes Lane 
25 x Piscataway, NJ 08854-4141 
26. 0d 
27 x This software file and its contents are provided on an "as is" 
28 x basis without any express or implied warranty, including without 
29 x limitation, any warranty that it is accurate, defect-free, free 
30 x from infringement, contains particular functions or is suitable 
31 x for a particular purpose. All express and implied statutory 
32 x warranties are disclaimed, including without limitation, the 
33 x warranty of merchantability, fitness for a particular purpose, 
34 x title or non-infringement. 
35 $ 
36 * NON-COMMON CAPABLE HEADER FILE 10-09-2007 
37 x/ 
38 
39 #include <stdio.h> 
40 #include <string.h> 
41 #include "PM_Plugin.h" 
42 
43 int virusScan(const char *tmpDirPath); 
44 
45 int PM PreInstall(PM RuntimeInfo *runtimeInfo, PM Descriptor *descriptor) 
46 ( 
47 const char xtmpDirPath = runtimeInfo->tempDirPath; 
48 
49 if (runtimeInfo->rollback) 
50 { 
51 //nothing to do. 
52 } 
53 else 
54 { 
55 if (virusScan(tmpDirPath) ) 
56 { 
57 snprintf (runtimeInfo-»errorMessage, 
58 PM MAX ERROR SIZE, 
59 "The path: $s can not pass the virus scan", 
60 tmpDirPath); 
61 return PM RESULT FAILURE; 
62 } 
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31 


63 } 

64 return PM RESULT. SUCCESS; 

65 } 

66 

67 int virusScan(const char *tmpDirPath) 
68 ( 


69 printf ("Virus scaning...\n"); 
70 return 0; 

71 ) 

72 
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